home *** CD-ROM | disk | FTP | other *** search
/ Products & Services for NeXT / Products & Services for NeXT.iso / AlembicDemo.app / ScriptWriter / CommandGroups / Sound.cmdgrp (.txt) < prev    next >
Encoding:
NeXT TypedStream Data  |  1993-07-19  |  44.3 KB  |  303 lines
  1. typedstream
  2. CommandGroup
  3. Object
  4. Sound
  5. Command
  6. NXImage
  7. NXBitmapImageRep
  8. NXImageRep
  9. iisssss00
  10. [576c]UUUUUUUUUUU@
  11. UUUUUUUUUUX
  12. NXCachedImageRep
  13. iiiiii00
  14. [4608c]U_U_U_U_doU_U_U_e_UOT_U_doUoU_U_ToU_UoV_T_UodoU_UOUOdoU_d_eOToU_e_UOe_U_D_VoT_UoeoU_UoV_d_
  15. COBOC?
  16. C?C?BO
  17. B/C?COC?B?C?
  18. B?R?B
  19. B/A/B
  20. R/Q/w
  21. foeofo
  22. Voeofo
  23. foeofof
  24. foeoVof
  25. VoUofo
  26. VoUoVoUoVoUo
  27. E_UoVoUoE_UoU_UoE_UoU_UoU_U_U_UoU_UoU_UoE_UoU_UoE_UoU_UoE_UoU_UoU_UoU_UoE_UoE_UoE_UoV_eo
  28. sndcompress
  29. "compress or decompress a soundfile
  30. *{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  31. \margl40
  32. \margr40
  33. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 sndcompress
  34. \b0  compresses or decompresses a soundfile. If the input soundfile is in a 16 bit linear format, it is compressed. If the input soundfile is in a compressed format, it is decompressed. The option controls the compression type; by default, bit-faithful compression is performed. With bit-faithful compression, the decompression operation reproduces the original sound exactly.
  35. CommandOption
  36. 9{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  37. \margl40
  38. \margr40
  39. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 This option controls the compression amount for lossy compression. Specify <n> as an integer: 4 <= n <= 8. Higher numbers give greater compression
  40. CommandArgument
  41. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  42. \margl40
  43. \margr40
  44. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The amount for lossy compression
  45. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  46. \margl40
  47. \margr40
  48. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 This option specifies lossless compression. A subsequent decompression will reproduce the original sound exactly
  49.     inputFile
  50. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  51. \margl40
  52. \margr40
  53. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The file to compress or decompress
  54. outputFile
  55. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  56. \margl40
  57. \margr40
  58. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The file after it is compressed or decompressed
  59. U_U_U_U_doU_U_U_e_UOT_U_doUoU_U_ToU_UoV_T_UodoU_UOUOdoU_d_eOToU_e_UOe_U_D_VoT_UoeoU_UoV_d_
  60. COBOC?
  61. C?C?BO
  62. B/C?COC?B?C?
  63. B?R?B
  64. B/A/B
  65. R/Q/w
  66. foeofo
  67. Voeofo
  68. foeofof
  69. foeoVof
  70. VoUofo
  71. VoUoVoUoVoUo
  72. E_UoVoUoE_UoU_UoE_UoU_UoU_U_U_UoU_UoU_UoE_UoU_UoE_UoU_UoE_UoU_UoU_UoU_UoE_UoE_UoE_UoV_eo
  73. UUUUUUUUUUU@
  74. UUUUUUUUUUX
  75. sndconvert
  76. )convert a soundfile to a different format
  77. <{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  78. \margl40
  79. \margr40
  80. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 sndconvert
  81. \b0  modifies the file according to various options. The various options allow conversion between formats, including non-soundfile formats.
  82. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;\f1\fswiss Helvetica;}
  83. \margl40
  84. \margr40
  85. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This option indicates that the output is to be written to the specified file. By default, soundfiles are modified in place, with the exception of a conversion that changes the file type (i.e. -d, -r, and -a options)
  86. outfile
  87. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  88. \margl40
  89. \margr40
  90. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 sndconvert
  91. \b0 's output will be written to this file
  92. \{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  93. \margl40
  94. \margr40
  95. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This specifies the resulting data format of the sound. The value of the number represents the format code; format codes are defined in <sound/soundstruct.h>. The default format code is the the input file's format code. The format conversions currently supported are SND_FORMAT_LINEAR_16 to SND_FORMAT_MULAW_8 SND_FORMAT_MULAW_8 to SND_FORMAT_LINEAR_16 SND_FORMAT_FLOAT to SND_FORMAT_LINEAR_16 SND_FORMAT_DOUBLE to SND_FORMAT_LINEAR_16
  96. infostring
  97. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  98. \margl40
  99. \margr40
  100. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The data format of the sound
  101. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;\f1\fswiss Helvetica;}
  102. \margl40
  103. \margr40
  104. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This allows the user to determine the scaling on the float-to-integer or integer-to-float translations. The scale factor used in translating float-to-integer is (float) * ((1 << scaleExponent)-1). The scale factor used in translating integer-to-float is (integer) / ((1 << scaleExponent)-1). The default scaleExponent is 15, which means that a float value of 1.0 is translated to the integer value of 32767. Using a scaleExponent of 23 translates a float value of 1.0 to a full-scale integer value used by the DSP56001
  105. scaleExponent
  106. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  107. \margl40
  108. \margr40
  109. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The scale exponent when scaling the sound
  110. "{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  111. \margl40
  112. \margr40
  113. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This specifies the resulting sampling rate of the sound. It may be a floating point number. The default sampling rate is the input file's sampling rate. If the source file is 44.1 kHz and the destination is a 22050 Hz file, then a sample rate conversion is performed. Sample rate conversion is also performed when converting 8 bit mulaw, 8012.821 Hz to 16 bit linear, 22050 Hz
  114. sampleRate
  115. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  116. \margl40
  117. \margr40
  118. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The sampling rate of the sound
  119. n{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  120. \margl40
  121. \margr40
  122. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This specifies the resulting number of channels of the sound. The default channel count is the input file's channel count. If the input file is mono (1 channel) and the channel count is 2, then a mono-to-stereo conversion is performed, for linear 16 or 32 bit files. If the input file is stereo (2 channels) and the channel count is 1, then a stereo-to-mono conversion (an equal mix of the two channels) is performed, also for linear 16 or 32 bit files
  123. channelCount
  124. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  125. \margl40
  126. \margr40
  127. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of channels of the sound
  128. N{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  129. \margl40
  130. \margr40
  131. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This specifies the input file to be a raw data file, to which a header is added. The resulting soundfile is of the same name as the input file with a .snd extension
  132. h{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  133. \margl40
  134. \margr40
  135. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This option specifies the input file to be a raw data file, as with the -r option, but the data format is ascii, with each number separated by newlines. The output files that can be generated from ascii input files are SND_FORMAT_LINEAR_16, SND_FORMAT_MULAW_8, SND_FORMAT_FLOAT, and SND_FORMAT_DOUBLE. If the output format is SND_FORMAT_LINEAR_16, input values are scaled by the scaleExponent specified with the -g option (the default is 32767.0)
  136. S{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  137. \margl40
  138. \margr40
  139. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 This option indicates that the file is a DSP absolute load image. The file must have a .lod extension, and the output file will be of the same name with a .snd extension
  140. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  141. \margl40
  142. \margr40
  143. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The sound file to convert
  144. U_U_U_U_doU_U_U_e_UOT_U_doUoU_U_ToU_UoV_T_UodoU_UOUOdoU_d_eOToU_e_UOe_U_D_VoT_UoeoU_UoV_d_
  145. COBOC?
  146. C?C?BO
  147. B/C?COC?B?C?
  148. B?R?B
  149. B/A/B
  150. R/Q/w
  151. foeofo
  152. Voeofo
  153. foeofof
  154. foeoVof
  155. VoUofo
  156. VoUoVoUoVoUo
  157. E_UoVoUoE_UoU_UoE_UoU_UoU_U_U_UoU_UoU_UoE_UoU_UoE_UoU_UoE_UoU_UoU_UoU_UoE_UoE_UoE_UoV_eo
  158. UUUUUUUUUUU@
  159. UUUUUUUUUUX
  160. sndinfo
  161. -displays soundfile headers on standard output
  162. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  163. \margl40
  164. \margr40
  165. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 sndinfo
  166. \b0  reads each file in sequence and displays the header information on standard output.
  167. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  168. \margl40
  169. \margr40
  170. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The file to display the headers for
  171. U_U_U_U_doU_U_U_e_UOT_U_doUoU_U_ToU_UoV_T_UodoU_UOUOdoU_d_eOToU_e_UOe_U_D_VoT_UoeoU_UoV_d_
  172. COBOC?
  173. C?C?BO
  174. B/C?COC?B?C?
  175. B?R?B
  176. B/A/B
  177. R/Q/w
  178. foeofo
  179. Voeofo
  180. foeofof
  181. foeoVof
  182. VoUofo
  183. VoUoVoUoVoUo
  184. E_UoVoUoE_UoU_UoE_UoU_UoU_U_U_UoU_UoU_UoE_UoU_UoE_UoU_UoE_UoU_UoU_UoU_UoE_UoE_UoE_UoV_eo
  185. UUUUUUUUUUU@
  186. UUUUUUUUUUX
  187. sndplay
  188. play soundfiles
  189. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  190. \margl40
  191. \margr40
  192. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b\i0\ulnone\fs24\fc0\cf0 sndplay
  193. \b0  reads each file in sequence and plays it on the standard sound-out hardware. The soundfiles may be of any playable type; runtime conversion is performed if possible. Emphasized formats are played with the built-in low-pass filter activated.
  194. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  195. \margl40
  196. \margr40
  197. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The file to play the sound from
  198. U_U_U_U_doU_U_U_e_UOT_U_doUoU_U_ToU_UoV_T_UodoU_UOUOdoU_d_eOToU_e_UOe_U_D_VoT_UoeoU_UoV_d_
  199. COBOC?
  200. C?C?BO
  201. B/C?COC?B?C?
  202. B?R?B
  203. B/A/B
  204. R/Q/w
  205. foeofo
  206. Voeofo
  207. foeofof
  208. foeoVof
  209. VoUofo
  210. VoUoVoUoVoUo
  211. E_UoVoUoE_UoU_UoE_UoU_UoU_U_U_UoU_UoU_UoE_UoU_UoE_UoU_UoE_UoU_UoU_UoU_UoE_UoE_UoE_UoV_eo
  212. UUUUUUUUUUU@
  213. UUUUUUUUUUX
  214.     sndrecord
  215. )record a soundfile from DSP or microphone
  216. 6{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  217. \margl40
  218. \margr40
  219. \pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b\i0\ulnone\fs24\fc0\cf0 sndrecord
  220. \b0  records sound from either the 8Khz microphone input on the back of the monitor, or from the DSP. By default, data is taken in from the microphone jack and placed in the named file. Alternatively, the data may be taken from a program running on the DSP. The default DSP program reads 16-bit-wide data in from the DSP serial input. The resulting file may be played back using sndplay(1).
  221. [12@]
  222. !{\rtf0\ansi{\fonttbl\f0\fmodern Courier;\f1\fswiss Helvetica;}
  223. \margl40
  224. \margr40
  225. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Record 16 bit data from the DSP serial input. The format of the data saved is 16 bit linear stereo
  226. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  227. \margl40
  228. \margr40
  229. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Record 24 bit data from the DSP serial input. The format of the data saved is 16 bit linear stereo
  230. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  231. \margl40
  232. \margr40
  233. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Specify that the data recorded from the DSP is emphasized
  234. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  235. \margl40
  236. \margr40
  237. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Run the specified program on the DSP recording it's output into the specified sound file
  238. dsp-program
  239. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  240. \margl40
  241. \margr40
  242. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The program to run on the DSP
  243. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  244. \margl40
  245. \margr40
  246. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Print warning messages if an output overflow is detected
  247. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  248. \margl40
  249. \margr40
  250. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Record at most size bytes into the output file
  251. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  252. \margl40
  253. \margr40
  254. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of bytes to record into the output file
  255. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  256. \margl40
  257. \margr40
  258. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Place the contents of comment-file into the output file
  259. comment-file
  260. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  261. \margl40
  262. \margr40
  263. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The comment file
  264. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  265. \margl40
  266. \margr40
  267. \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Place the contents of comment-file into the output file
  268. f{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  269. \margl40
  270. \margr40
  271. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Set the high water mark used by the the operating system in wiring down memory to record into. The operating system will try to wire down enough physical pages to reach the high water mark
  272. high-water-mark
  273. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  274. \margl40
  275. \margr40
  276. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The high water mark
  277. 7{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  278. \margl40
  279. \margr40
  280. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Set the low water mark used by the operating system. The operating system ensures that at least this many bytes are wired down to record into
  281. low-water-mark
  282. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  283. \margl40
  284. \margr40
  285. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The low water mark
  286. X{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  287. \margl40
  288. \margr40
  289. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Set the size of the buffers used by the operating system for a unit of recording. This size must be a power of two less than or equal to the physical page size of the machine
  290. dma-size
  291. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  292. \margl40
  293. \margr40
  294. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The size of the dma buffers
  295. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  296. \margl40
  297. \margr40
  298. \pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Print out state useful for determining the internal behavior of sndrecord. Of marginal use
  299. {\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
  300. \margl40
  301. \margr40
  302. \pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The file to put the recording into
  303.